home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / utils / sift10.arj / SIFT.DOC < prev    next >
Text File  |  1993-06-27  |  11KB  |  299 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         
  8.                             
  9.                             
  10.                             
  11.                             
  12.                             
  13.                             
  14.                             
  15.                             
  16.                             
  17.                             
  18.                             
  19.                             
  20.                             
  21.                             
  22.                             
  23.                             
  24.                                STEENBURGH'S STUFF
  25.                             Mildly Useful Utilities
  26.                                 For Batch Files
  27.                                  Version  3.0
  28.           Copyright 1991-1993 by Chuck Steenburgh and Tay-Jee Software
  29.         
  30.                              _______
  31.                         ____|__     |               (TM)
  32.                      --|       |    |-------------------
  33.                        |   ____|__  |  Association of
  34.                        |  |       |_|  Shareware
  35.                        |__|   o   |    Professionals
  36.                      -----|   |   |---------------------
  37.                           |___|___|    MEMBER
  38.         
  39.         
  40.         
  41.         
  42.         
  43.         
  44.         
  45.         
  46.         
  47.         
  48.         
  49.         
  50.         
  51.         
  52.         
  53.         
  54.         
  55.         
  56.         
  57.         
  58.         
  59.         
  60.         SIFT Version 1.0
  61.  
  62.                                      Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         Copyright 1993 Chuck Steenburgh & Tay-Jee Software
  69.         
  70.         
  71.            The three filters that come with DOS, MORE, FIND, and SORT,
  72.         are indispensable batch file programming tools.  Unfortunately,
  73.         as useful as they are, they are still fairly limited in what
  74.         they can do.  SIFT is a multi-purpose DOS filter that greatly
  75.         expands on the capabilities of FIND.
  76.         
  77.         Syntax:
  78.         
  79.              SIFT [options] < source
  80.             source | SIFT [options]\n");
  81.             
  82.         [options]    one or more of the following:\n");
  83.                   
  84.                   /a              Non-numeric output only.  Strips all
  85.                                   numbers from output.
  86.                                   
  87.                   /b              Backwards (reverse) output.  Reverses
  88.                                   each line of filtered text.
  89.                                   
  90.                   /c              Display occurence of find only (iden-
  91.                                   tical to FIND).
  92.                                   
  93.                   /d              Numeric output only.  Strips all non-
  94.                                   numeric characters from output.
  95.                                   
  96.                   /e[nnn]         Convert to non-graphic characters.
  97.                                   SIFT will normally substitute the "*"
  98.                                   (ASCII 42) character unless an alter-
  99.                                   nate ASCII value is specified as nnn.
  100.                                   
  101.                   /fxxxxxx        Output (find) lines containing string
  102.                                   xxxxxx only.
  103.                                   
  104.                   /i              case-insensitive find (/f or /v)
  105.                                   (identical to FIND).
  106.                                   
  107.                   /l              convert output to lowercase
  108.                   
  109.                   /n              display line numbers of output (iden-
  110.                                   tical to FIND).
  111.                                   
  112.                   /pnn            inverse truncate after nn characters
  113.                                   (print output, skipping first nn char-
  114.                                   acters).
  115.                   
  116.                   /r              display number of occurence of output
  117.                                   (relative position of find)
  118.                   
  119.                   /tnn            truncate output to nn characters
  120.                   
  121.                   /u              convert output to uppercase
  122.  
  123.                                      Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                   
  130.                   /vxxxxxx        display lines NOT containing string 
  131.                                   xxxxxx
  132.                             
  133.                   /2              Two-column output.  Successive lines
  134.                                   of less than 40 characters are com-
  135.                                   bined on the same output line.
  136.                                   
  137.                   /h or /?        Display help screen
  138.         
  139.         
  140.            SIFT is essentially a superset of the FIND filter, providing
  141.         many more functions.  It uses the basic syntax of the FIND com-
  142.         mand.
  143.         
  144.         Examples:
  145.         
  146.              PATH | SIFT /P5
  147.              
  148.            Displays the PATH setting, excluding the first 5 characters
  149.         (i.e., "PATH=").
  150.         
  151.              SIFT /FTay-Jee /I /D < PHONE.LST
  152.            
  153.            Searches the file PHONE.LST for the string "Tay-Jee" (any
  154.         case) and outputs all NUMERIC values on that line.  Useful,
  155.         for example, in finding/displaying phone numbers or other
  156.         values.
  157.          
  158.                                                                    
  159.         OMBUDSMAN
  160.         
  161.           This program is produced by a member of the Association of
  162.         Shareware Professionals (ASP).  ASP wants to make sure that
  163.         the shareware principle works for you.  If you are unable to
  164.         resolve a shareware-related problem with an ASP member by
  165.         contacting the member directly, ASP may be able to help.  The
  166.         ASP Ombudsman can help you resolve a dispute or problem with
  167.         an ASP member, but does not provide technical support for 
  168.         members' products.  Please write to the ASP Ombudsman at 545
  169.         Grover Road, Muskegon, MI 49442 or send a CompuServe message
  170.         via CompuServe Mail to ASP Ombudsman, 70007,3536.
  171.         
  172.         
  173.         DISCLAIMER
  174.         
  175.            The programs described in this documentation are guaran-
  176.  
  177.                                      Page 3
  178.  
  179.  
  180.  
  181.  
  182.  
  183.         teed to do absolutely nothing!  They have, however, in my exper-
  184.         ience performed essentially as described herein.  The author
  185.         will not be responsible for any loss or damages caused through
  186.         the use of these programs.  No warranty, express or implied,
  187.         is provided for this software's performance, merchantability,
  188.         or fitness for a particular purpose.
  189.         
  190.            All trademarks are property of their respective owners.
  191.         
  192.            The programs and documentation are Copyright 1991,1992 by 
  193.         Chuck Steenburgh.  You are encouraged to distribute these pro-
  194.         grams provided the following conditions are met:
  195.         
  196.            - all files contained in the archive or distribution disk
  197.              must be distributed together in UNMODIFIED form
  198.         
  199.            - you charge no more than a reasonable fee for copying or
  200.              subscription, and clearly indicate that payment of such
  201.              a fee does NOT grant ownership of the programs.
  202.         
  203.            This program is part of set of utilities known as STEEN-
  204.         BURGH'S STUFF (Mildly Useful Utilities).  The full set of
  205.         utilities includes the following programs:
  206.         
  207.              BATBOX:     Simple menu creation/input system
  208.              CHKDRV:     Checks disk drive status
  209.              CHKPRN:     Checks parallel printer status
  210.              CLK:        Displays time on screen
  211.              CURSOR:     Change cursor shape
  212.              DOSVER:     Checks for DOS version currently running
  213.              INPUT:      Simple prompt/input system
  214.              KLS:        Colorful screen-clearing utility
  215.              LAUNCHER:   File selection/execution system
  216.              MUSIC:      Plays transcribed sheet music on the PC
  217.              RAND:       Random number generator
  218.              SKIP:       Prints blank lines from batch files
  219.              SOUNDER:    Wide range of noise making options
  220.              SPACE:      File/disk space reporting utility
  221.              WAITFOR:    Timed pauses 
  222.              WHENISIT:   Date/time telling utility
  223.              WRITE:      Colorful output anywhere on screen
  224.              XD:         Create/switch directories at the same time
  225.         
  226.            You may evaluate these programs for up to 30 days on a free
  227.         trial basis.  After 30 days, you should register your use of
  228.         these programs.  The registration fee is $20, payable to the
  229.         author at the address given below.  For those registering
  230.         directly with Tay-Jee Software, we offer a $5 cash discount.
  231.         
  232.            Let's be real: I don't plan to make a lot of money this way.
  233.         Registration does have its advantages:
  234.         
  235.            - I am improving these programs all the time.  Registration
  236.              will get you IMMEDIATELY a disk with the latest version.
  237.  
  238.                                      Page 4
  239.  
  240.  
  241.  
  242.  
  243.  
  244.              You will also get the next major release of the program set
  245.              sent to you free of charge.
  246.         
  247.            - While I can't promise to include everyone's suggestions
  248.              in program updates, you can bet I'll listen to registered
  249.              users before any of you scrounges out there.
  250.         
  251.            - You will make me feel all warm and fuzzy and appreciated, 
  252.              and all that good stuff.
  253.         
  254.            - You will also get an evaluation copy of my text file for-
  255.              matting program (used to produce the margins in this doc-
  256.              ument), and any other electronic creations I have decided
  257.              to unleash on a foolish, unsuspecting world.
  258.         
  259.            Send comments/registrations to:
  260.         
  261.                 Tay-Jee Software
  262.                 Post Office Box 835
  263.                 Lexington, VA 24450
  264.                 (703)464-5290
  265.                 
  266.                 !!!VIRGINIA RESIDENTS ADD 4.5SALES TAX!!!
  267.         
  268.                 CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums)
  269.         
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.                                      Page 5